home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / khor-faq.zip / KHOR-FAQ next >
Text File  |  1993-01-27  |  67KB  |  1,458 lines
  1.  
  2.  
  3.         FREQUENTLY ASKED QUESTIONS ABOUT KHOROS
  4.  
  5.                 last updated:
  6.                      Jan 8, '93 -- added 3 new Q & A's 
  7.                            concerning 24-bit, new
  8.                            Q29 - Q31. 
  9.                         
  10.         ( Please Read!  Please Redistribute! )
  11.  
  12.         ( Also - Please See the Khoros FAQ for Compiling )
  13.  
  14.       Contents:  Questions 1 - 51
  15.          
  16.              * Introductory Khoros
  17.              * Mailing List, News Group, User Support, Etc
  18.              * General Khoros
  19.              * Manuals, Documentation, Man Pages
  20.              * 24 Bit Displays
  21.              * Problems With Displaying Images
  22.              * Problems with SGI 
  23.              * Annotations, Editimage, Xprism2/3, Animate  
  24.              * Problems with Graphical User Interface 
  25.              * and more
  26.  
  27. ------- Introductory Khoros (obtaining Khoros, patches) -----
  28.  
  29. Q1.  What is the Khoros System?
  30.  
  31. Q2.  How do I obtain the Khoros system?
  32.      What is the most recent version of Khoros?
  33.  
  34. Q3.  What is a "Patch"? What does "Patch Level" mean?  
  35.  
  36. Q4.  How can I find out what patch level our Khoros system is at?  
  37.  
  38. Q5.  How do I get the latest patch to Khoros?
  39.  
  40. Q6.  Do I want the most recent patch?  What changes have been made 
  41.      in the patches to Khoros?
  42.  
  43. Q7.  What if I don't have access to the net / don't have the
  44.      ftp program / don't want to bother with ftp / but still want Khoros?
  45.  
  46. -------  Mailing list, News Group, User Support, Etc -----
  47.  
  48. Q8.  I want to get on / off the khoros mailing list,
  49.      I want to get on / off the digestified mailing list.
  50.  
  51. Q9.  Is there a network news group that I can read which talks about Khoros?
  52.      Is there a mail archive of the news group that I can get?
  53.  
  54. Q10. I have a question to ask.
  55.  
  56. Q11. I have a bug to report.
  57.  
  58. Q12. I have a desired enhancement I would like you to know about.
  59.  
  60. Q13. Is there a book on Khoros that I can get?
  61.  
  62. Q14. What support is provided for Khoros by the Khoros group at UNM?  
  63.      What if I need additional support?
  64.  
  65. -------  General Khoros -----
  66.  
  67. Q15. What is the Khoros Consortium?  What are the benefits of joining
  68.      the Consortium?  How much does it cost?
  69.  
  70. Q16. What machines does Khoros currently run on? 
  71.  
  72. Q17. Does Khoros work with shared libraries? 
  73.  
  74. Q18. Can you use C++ with Khoros?  How?
  75.  
  76. Q19. What file formats are supported by Khoros?  If Khoros doesn't support
  77.      my file format, is there any way to get my data into the Khoros system?
  78.  
  79. Q20. I have some GIF images that I would like to use with Khoros.  Is
  80.      there a GIF to VIFF converter?
  81.  
  82. Q21. I would like to remove all of Khoros that is not needed to 
  83.      actually run it, in order to free up disk space.   What can
  84.      be removed without compromising the integrity of the runtime 
  85.      operation of Khoros?
  86.  
  87. Q22. Is it possible to get only a subset of Khoros?  I realize that
  88.      Khoros has a core of utility routines that must be obtained, but
  89.      I was hoping that one could pick and choose the routines one wanted
  90.      on an as-needed basis.
  91.  
  92.  
  93. -------  Manuals, Documentation, Man Pages --------------
  94.     
  95. Q23. Can I buy the manuals separately?
  96.  
  97. Q24. How do I print the documentation?
  98.  
  99. Q25. I want to read the Khoros man pages, but vman doesn't seem to work.
  100.      What's the problem?
  101.  
  102. Q26. I can not regenerate the Khoros manual on a Sun Workstation
  103.      because soelim for .so lines in the roff files, limits the
  104.      file length to 64 characters.
  105.  
  106.  
  107. -------  24 bit displays --------------
  108.  
  109. Q27. Does Khoros work with 24-bit displays?  Can I expect any particular
  110.      problems when I run Khoros applications on my 24-bit display?
  111.  
  112. Q28. Is there a way to load a 24-bit image, display it on an 8-bit display 
  113.      (using 3-3-2, or 7 levels each of rgb), and allow LUT manipulations, 
  114.      histograms, etc, to be done on the original values?  
  115.  
  116. Q29. When running warpimage on a 24-bit display, it fails and gives me
  117.      this X Protocol error:
  118.  
  119.      X Error of failed request:  BadMatch (invalid parameter attributes)
  120.      Major opcode of failed request:  72 (X_PutImage)
  121.      Minor opcode of failed request:  0
  122.      Resource id in failed request:  0x3800060
  123.      Serial number of failed request:  1783
  124.      Current serial number in output stream:  1810
  125.      Major X error encountered for display ':0.0'! Unable to recover.
  126.  
  127. Q30. When running editimage and using the zoom, ROI, or annotations options 
  128.      on a 24-bit display, it fails and gives me this X Protocol error:
  129.  
  130.      X Error of failed request: BadMatch (invalid parameter attributes)
  131.      Major opcode of failed request: 72 (X_PutImage)
  132.      Minor opcode of failed request: 0
  133.      Resource id in failed request:  0x4000041
  134.      Serial number of failed request: 6750
  135.      Current serial number in output stream: 6751
  136.      Major X error encountered for display ':0.0'! unable to recover.
  137.  
  138. Q31. I cannot seem to view my 24-bit image properly with editimage on
  139.      my SGI 24-bit display.  Editimage insists on compressing my image
  140.      to 8-bit PsuedoColor, but I don't want that.
  141.  
  142.  
  143. -------  Problems with Displaying Images --------------
  144.  
  145. Q32. I'm on a SUN architecture, using OpenWindows.  When I display images,
  146.      they come up  with colored speckles in them, or strangely colored in
  147.      some way. This condition rights itself when I move the cursor into 
  148.      the image, but then the colors in my user interface get messed up -
  149.      sometimes I can't see anything but the image.  Is this a bug in Khoros?
  150.  
  151. Q33. When I display an image that has a large number of colors in it
  152.      the colors will not be displayed correctly unless
  153.      I move my mouse into the image;  then, all my other windows lose
  154.      their colors.  How can I get rid of this "techno-flash" phenomenon?
  155.      NOTE: there is a difference between this problem and the one mentioned
  156.      in Q32.  In Q32, the graphical user interface is lost;  here, the
  157.      graphical user interface is preserved, but colors in other windows
  158.      are lost.
  159.  
  160. -------  Problems with SGI --------------
  161.  
  162. Q34. The Khoros display programs are not working on SGI machines.  The 
  163.      symptom is that when displaying images a title bar will appear, but 
  164.      no window -- just an hole where the image should be.  
  165.  
  166. Q35. On our SGI (NCD terminal with an SGI server), when the Khoros 
  167.      applications come up, they have extremely large graphical user 
  168.      interfaces.  The user interface is so large, it doesn't even fit 
  169.      on the screen!  What can I do?
  170.  
  171.  
  172. -------  Annotations, Editimage, Xprism2/3, Animate  --------------
  173.  
  174. Q36. I have a problem with the annotations capability in editimage (xprism).
  175.      When I move the image (plot), the annotations don't move accordingly.
  176.      It seems that they are tied to the device coordinates of the screen,
  177.      rather than the pixels in the image (world coordinates of the plot)
  178.      as they should be.
  179.  
  180. Q37. I am trying to load 3D data into xprism3 from an ASCII file.
  181.      When I try to plot the data, a pop-up window states that there 
  182.      is 1 row and (total # data points) columns, and asks for the correct
  183.      number of rows. What is going on?
  184.  
  185. Q38. What does the "*" mean after a pixel value at the bottom of
  186.      the editimage window?
  187.  
  188. Q39. I am running animate on a DecStation 5000/200.  Animate is so slow that
  189.      it is unusable.  Occasionally, it even seems to lock up the display.
  190.      What is the problem?
  191.  
  192. Q40. When plotting raw ASCII data specified in XYZ format, does the data 
  193.      have to be rectangular, or can I provide irregular data?  Does each 
  194.      row have to have the same number of elements?  Is there anyway to plot 
  195.      3D data that has a varied number of points per row?
  196.  
  197. -------  Problems with Graphical User Interface --------------
  198.  
  199. Q41. I have a version of Khoros installed on a DecStation running the 
  200.      dxwm window manager (DecWindows).  I have problems with running
  201.      Khoros programs -- some of the buttons do not work at all, while
  202.      others sometimes lock the program, or otherwise do not act properly.
  203.      What's wrong?
  204.  
  205. Q42. I'm using khoros on a monochrome monitor. I have connected up some glyphs
  206.      in the cantata workspace, but the connections don't appear on the screen,
  207.      even though the workspace executes correctly.
  208.  
  209.  
  210. -------  Writing New Programs in Khoros --------------
  211.  
  212. Q43. I have finished writing my new program under Khoros, and now
  213.      I would like to install it into a toolbox, and integrate it 
  214.      into the cantata visual language.  How do I go about doing this?
  215.  
  216. Q44. Is there a tutorial describing how to create and install an xvroutine?
  217.  
  218. Q45. Can user-written routines be installed under existing buttons on
  219.      the Cantata workspace? For example, if I have written a new
  220.      signal processing routine, can I fix things so that it appears
  221.      on the menu under the Signal Processing button, or do I have to
  222.      install it in a new toolbox?
  223.  
  224. -------  Miscellaneous --------------
  225.  
  226. Q46. Where did you get the name "Khoros"? Is it an acronym?
  227.  
  228. Q47. I would like to do 3D object modelling, with multiple light sources,
  229.      animation, and so on.  Does Khoros do this?
  230.  
  231. Q48. I heard about the audio cantata demo, and would like to hear it.
  232.      How do I go about this?
  233.  
  234. Q49. Is there a way to convert VIFF images with 3 color bands (rgb) to
  235.      images with only one band and a colormap?  What about vice versa?
  236.  
  237. Q50. We are trying to run cantata on an NCD Xterminal as the display, 
  238.      and the program fails, exiting with the following error:
  239.  
  240.        X Error:  BadAlloc
  241.        Request Major code 65 ()
  242.        Request Minor code 0
  243.        ResourceID 0x2400085
  244.        Error Serial #1576
  245.        Current Serial #1582
  246.        Major X error encountered for display ':0'! Unable to recover.
  247.  
  248. Q51. When I try to use my double or double complex viff image that came from
  249.      another kind of machine, the program always gives an error.  What gives?
  250.  
  251.  
  252. ==============================================================================
  253.  
  254. ============= Introductory Khoros (obtaining Khoros, patches) ================
  255.  
  256.  
  257.     Q1. What is the Khoros system?
  258.  
  259.     A1. Khoros is an integrated software development environment for 
  260.         information processing and visualization, based on X11R4.  Khoros 
  261.         components include a visual programming language, code generators 
  262.         for extending the visual language and adding new application packages 
  263.         to the system, an interactive user interface editor, an interactive 
  264.         image display package, an extensive library of image processing,
  265.         numerical analysis and signal processing routines, and 2D/3D
  266.         plotting packages.
  267.  
  268.         *  X Windows Applications:
  269.         Animate - Interactive Image Sequence Display Tool
  270.         Cantata - Extensible Visual Programming Language
  271.         Concert - A system for distributed X user interfaces (groupware)
  272.         Editimage - Interactive Image Display & Manipulation Program
  273.         Xprism2 and Xprism3 - Comprehensive 2D and 3D Plotting Packages
  274.         Viewimage - A basic interactive program for surface rendering
  275.         Warpimage - An interactive program for registering and warping images
  276.  
  277.         *  Data Processing Algorithms:
  278.         Khoros contains over 260 programs, in the following
  279.         categories: arithmetic, classification, color conversion,
  280.         data conversion, file format conversion, feature extraction,
  281.         frequency filtering, matrix algebra (LINPACK and EISPACK),
  282.         spatial filtering, morphology filtering, geometric manipulation, 
  283.     histogram manipulation, statistics, signal generation,
  284.         linear operations, segmentation, spectral estimation, sub-
  285.         region, and transforms. Khoros supports the following file
  286.         formats: TIFF, pbm, BIG, DEM, DLG, ELAS, FITS, MATLAB, Sun
  287.         raster, TGA, and xbm.
  288.  
  289.         *  User Interface Tools
  290.         Preview  - Graphical User Interface Display Tool
  291.         Composer - Interactive Graphical User Interface Editor
  292.         Conductor - Code Generation Tool for a Graphical User Interface
  293.         Ghostwriter - Code Generation Tool for a Command Line User Interface
  294.         Source Configuration & Management - Tools to install and maintain a
  295.                                     distributed source tree.
  296.  
  297.     For complete details, please read the "announce.ftp" and "khoros.ftp"
  298.         documents that are available in the khoros release/ directory.
  299.         These documents can be obtained via anonymous ftp from any official
  300.         Khoros ftp site (see Q2).
  301.         
  302.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  303.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  304.  
  305.     Q2. How do I obtain the Khoros system?
  306.     What is the most recent version of Khoros?
  307.  
  308.     A2.              ----  anonymous  ftp ----
  309.     The most recent version of Khoros, Khoros 1.0 Patch 5, can be 
  310.     obtained free of charge via anonymous FTP.
  311.     Our official FTP site from which you can get
  312.     the Khoros system is listed below.   
  313.  
  314.         USA:             ftp pprg.eece.unm.edu  (129.24.24.10)        
  315.     (University of     Login:  anonymous  (or ftp)
  316.          New Mexico)    Password: user_name@machine
  317.                       cd /pub/khoros
  318.  
  319.         In all cases, we recommend that you first obtain the "install.ftp",
  320.         "install.ms", or "install.ps" installation document found in the
  321.         release/ directory, and read it before attempting to obtain the 
  322.         Khoros system.  The Khoros system is large, and fewer mistakes will 
  323.         be made if the proper documentation is read beforehand.
  324.  
  325.                     ----  USA tape orders ----
  326.     If you are not on the network, or do not want to use ftp for some
  327.     reason, you may order a tape of Khoros and printed manuals for a 
  328.     fee of $250 from:
  329.  
  330.     The Khoros Group
  331.     Room 110  EECE Dept.
  332.     University of New Mexico, 
  333.     Albuquerque, NM 87131
  334.     email: khoros-request@chama.eece.unm.edu
  335.  
  336.     Please mail khoros-request@chama.eece.unm.edu to obtain the order
  337.     form that must be filled out to place your order.
  338.  
  339.                     ----  Europe tape orders ----
  340.     In Europe, you may order a tape from:
  341.  
  342.     Pascal ADAM
  343.     DTA / LETI / DEIN / SIR
  344.     CEN SACLAY
  345.     91191 Gif / Yvette Cedex FRANCE
  346.     tel: 33 1 69 08 82 91
  347.     fax: 33 1 69 08 83 95
  348.     email: padam@fauvette.saclay.cea.fr
  349.  
  350.  
  351.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  352.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  353.  
  354.    Q3. What is a "Patch"?  What does "Patch Level" mean?  
  355.  
  356.    A3. Periodically, we release "patches" to the Khoros system.  In general,
  357.        a "patch" to a program means that the author made one or more bug fixes
  358.        to the program.  These bug fixes are then made available to users of the 
  359.        program in the form of context diff files, which are applied to the
  360.        original program with the public domain "patch" program in order to 
  361.        bring it up to date. In general, patches are small, fixing a few 
  362.        reported bugs and nothing more;  they are released frequently following 
  363.        the release of a software package, as the author(s) endeavor to make 
  364.        the original program solid and reliable before moving on work on the 
  365.        next version of the program.
  366.  
  367.        When used with respect to the Khoros system, however, the term "Patch"
  368.        is used rather loosely.  "Patches" to the Khoros system would more 
  369.        suitably be termed "minor releases".  They are made available to users
  370.        in the form of large tar files, and the use of the "patch" program used
  371.        on context diff files was abandoned after the first try, as it was 
  372.        simply not sufficient to address the number of changes that were 
  373.        included.  Patches to the Khoros system are large, fixing dozens of
  374.        bugs and introducing major enhancements to the Khoros system;  they
  375.        are released infrequently, often with 2-3 months elapsing between
  376.        patches, as the authors attempt to make new capabilities available
  377.        to users.
  378.  
  379.        In any case, "Patch Level" refers to the number of patches that
  380.        have been applied to the software at a certain site;  for example,
  381.        if three patches have been acquired and applied to the software, that
  382.        software would be said to be "at Patch Level 3".   In addition to
  383.        making patches available to users who already have the Khoros system,
  384.        we also apply the same patches to the Khoros system which is available
  385.        via public ftp.  Thus, if you acquired the Khoros system after Patch 3
  386.        was released, your software would still be said to be "at Patch Level 3",
  387.        regardless of the fact that you had never actually applied any patches.
  388.  
  389.  
  390.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  391.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  392.  
  393.     Q4. How can I find out what patch level our Khoros system is at?  
  394.        
  395.     A4. If you do not know what patch level your version of Khoros is at,
  396.         look in $KHOROS_HOME/src for a file called "PatchLevel".  The one-line
  397.         contents of this file will tell you what patch level the system is at.
  398.         If the file does not exist, you probably have the original
  399.         Khoros 1.0 with no patches applied,  although some sites may still 
  400.         have the Beta version of Khoros.  The Khoros Manuals will indicate 
  401.         if you still have Khoros Beta.
  402.  
  403.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  404.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  405.  
  406.     Q5. How do I get the latest patch to Khoros?
  407.  
  408.     A5. If you are acquiring the Khoros system for the first time, see Q2.
  409.     The distributed version of Khoros on pprg.eece.unm.edu always has
  410.         the most recent patch incorporated.  If you have an existing version
  411.         of Khoros, do an anonymous ftp to pprg.eece.unm.edu  (129.24.24.10);
  412.         the most recent patch is in /pub/khoros/patch/patchN, where patchN
  413.         is the most recent patch.  Follow the instructions in the README found 
  414.     in that directory for installing the patch.  ONLY install patchN onto
  415.         a Khoros system which is currently at Patch Level N-1. If your version
  416.     of Khoros is at Patch Level N-2 or earlier, re-acquire the entire 
  417.     system from scratch as explained in Q2.
  418.  
  419.     IMPORTANT:  You must ALWAYS have the same release of "system" to go 
  420.     with either a release of "source" or a release of "binaries".  
  421.  
  422.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  423.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  424.         
  425.    Q6.  Do I want the most recent patch?  What changes have been made
  426.         in the patches to Khoros?
  427.  
  428.    A6.  Of course you will want the most recent patch if you want to stay 
  429.         up to date with what we are doing with the Khoros system.  The changes 
  430.         that have been made in each patch are too extensive to list here;  
  431.         however, a complete list of changes that were made during Patch N can 
  432.         be obtained by ftp'ing to pprg.eece.unm.edu (129.24.24.10), and getting 
  433.     /pub/khoros/patch/patchN/README.
  434.  
  435.        
  436.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  437.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  438.  
  439.    Q7.  What if I don't have access to the net / don't have the
  440.     ftp program / don't want to bother with ftp?
  441.  
  442.    A7.    If you don't want to ftp the system yourself, you may
  443.     get a tape and printed documentation from UNM. It will cost 
  444.         $250 if you are in the United States or Canada, $350 internationally.
  445.  
  446.     MAIL ORDERS:
  447.     First, get an order form.   You may ftp to of the sites listed 
  448.     above and get the announce.ftp document (which contains the order
  449.     form), or mail khoros-request@chama.eece.unm.edu and request an order
  450.     form.  Fill out the order form and send it to the 
  451.     address listed on it with a check or purchase order for 
  452.     $250 made out the University of New Mexico.
  453.     
  454.         FAX ORDERS:
  455.     You can FAX orders to UNM at 505-277-1439
  456.  
  457.     CREDIT CARD ORDERS:    
  458.     You can use your credit card to order Khoros, provided that you
  459.     specify all the necessary information (name, credit card number,
  460.     expiration data, daytime phone number) on your order form.
  461.         We do not accept American Express.
  462.  
  463.     ORDER INFORMATION:
  464.     email khoros-request@chama.eece.unm.edu
  465.  
  466.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  467.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  468.  
  469. ============= Mailing list, News Group, User Support, Etc =====================
  470.  
  471.     Q8. I want to get on / off the khoros mailing list,
  472.     I want to get on / off the digestified mailing list.
  473.  
  474.     A8. PLEASE don't mail these requests to khoros@chama.eece.unm.edu!
  475.         Over 1000 people who don't care will be getting your request.
  476.         Mail to khoros-request@chama.eece.unm.edu, and we will process
  477.         your request as soon as we can.
  478.  
  479.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  480.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  481.  
  482.     Q9. Is there a network news group that I can read which talks 
  483.         about Khoros?  Is there a mail archive of the news group
  484.         that I can get?
  485.  
  486.     A9. Yes.  We have our own news group, comp.soft-sys.khoros.
  487.         Note that all messages to the mailing list are cross-posted to the
  488.         news group and vice versa;  thus, you may want to be on the mailing
  489.         list or read the news group, but it is not necessary to do both.
  490.  
  491.         We do have a mail archive, but it is unfortunately not updated 
  492.         automatically;  at this time, it is only updated when patches are
  493.         released.  However, on the philosophy that something is better than
  494.         nothing, you can do an anonymous ftp to pprg.eece.unm.edu (129.24.24.10)
  495.     and get the files found in /pub/khoros/mail_archive.
  496.  
  497.     For researching previously-posted mail to comp.soft-sys.khoros, 
  498.     you can also make use of the WAIS server for Khoros mail, provided
  499.     by Mathew Yeates of the Image Analysis Systems Group, JPL.  
  500.     WAIS - The Wide Area Information Servers system, is a set of products 
  501.     supplied by different vendors to help end-users find and retrieve 
  502.     information over networks.   It can be obtained from think.com.
  503.  
  504.     The server is running at henry.jpl.nasa.gov on port 1025 and the 
  505.     database name is khorosmail. As an example:
  506.  
  507.     % waissearch -p 1025 -h henry.jpl.nasa.gov -d khorosmail ansi
  508.  
  509.     This gives a list of mail containing the keyword "ansi". Next, you may
  510.     choose which mail to read (xwais is a better interface).  
  511.     Please direct any questions about WAIS to alt.wais, not 
  512.     comp.soft-sys.khoros.
  513.  
  514.     This is a temporary service provided for members of the Khoros 
  515.     community by Mathew Yeates, and may go away at any time, depending
  516.     on any adverse effects that it may have on his machine.  Thanks go
  517.     to Mathew (mathew@elroy.jpl.nasa.gov) for providing this service.
  518.     
  519.  
  520.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  521.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  522.  
  523.    Q10. I have a question to ask.
  524.  
  525.    A10. If you have a question, mail to our mailing list: 
  526.         khoros@chama.eece.unm.edu.  When mailing questions, please follow 
  527.         the proper mail etiquette by including enough information for us 
  528.         to understand your situation.  Indicate what machine architecture 
  529.         and operating system you are using.  Include complete details so as 
  530.         to exactly describe your problem.  Do not mail long files to the
  531.         mailing list, such as make.World files, or saved cantata workspaces.
  532.  
  533.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  534.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  535.  
  536.    Q11. I have a bug to report.
  537.  
  538.    A11. If you have a bug report, mail to khoros-bugs@bullwinkle.eece.unm.edu.
  539.         Please use the Bug Report form found in $KHOROS_HOME/repos/BugReport.
  540.     It is very difficult for us to trace bugs when we don't have enough
  541.     background information.  Also, it will help if you first read
  542.     $KHOROS_HOME/repos/BugList, which lists currently known bugs in Khoros.
  543.     We rarely respond to reports mailed to khoros-bugs;  however, we do
  544.     log them in our list of bugs to be dealt with. In the future, we hope 
  545.     to implement an automatic reply so that you know your mail was received.
  546.     Please *DO* send bug reports on any documentation errors you may find,
  547.     no matter how "nit-picky" they may seem!  We don't have a professional
  548.     proof reader, so any reports you make are *truly* appreciated!
  549.         Please *don't* send questions to khoros-bugs -- they probably will not 
  550.     be answered, as this account is for logging of bugs & desired 
  551.     enhancements only.  
  552.  
  553.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  554.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  555.  
  556.    Q12. I have a desired enhancement that I would like you to know about.
  557.  
  558.    A12. If you would like to request an enhancement to a program,
  559.      mail to khoros-bugs@bullwinkle.eece.unm.edu.  You don't need to use
  560.     the Bug Report form, but please be clear and give enough information
  561.     so that we will exactly what the enhancement is.  We cannot promise
  562.     that desired enhancements will be implemented. 
  563.  
  564.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  565.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  566.  
  567.    Q13. Is there a book on Khoros that I can get?
  568.  
  569.    A13. Not at this time, but there is a book scheduled to begin development 
  570.         this year by Carla Williams, PhD.  An outline of the book has been 
  571.     decided on;  it will include writings from a number of authors, 
  572.     and will address the solution of various scientific problems using
  573.     the Khoros system.
  574.  
  575.     We do recommend "AN INTRODUCTORY GUIDE TO SCIENTIFIC VISUALIZATION",
  576.     by R. A. Earnshaw (University of Leeds) and and N. Wiseman (Natural 
  577.     Environment Research Council), published by Springer-Verlag, 157 pp, 
  578.     which was published in July 1992.  It has a low price and popular 
  579.     presentation style, and it does include information on Khoros in 
  580.     Chapter 8, section 8.1.  A summary of this book appears below:
  581.  
  582.     This volume is intended for readers new to the field of scientific
  583.     visualization, and who require a quick and easy-to-read summary of what
  584.     the field is  and what it can do. Written in a popular journalistic 
  585.     style with many illustrations, it will enable readers to appreciate 
  586.     the benefits of scientific visualization and how current tools can be 
  587.     exploited in many application areas.  This volume is indispensable 
  588.     for scientists and research workers who have never used computer 
  589.     graphics or other visual tools before, and who wish to find out the 
  590.     benefits and advantages of the new approaches.  This guide is concerned
  591.     with answering the following questions -
  592.  
  593.     o What is Scientific Visualization?
  594.     o What can it do?
  595.     o What do the technical terms and jargon really mean?
  596.     o What products are currently available?
  597.     o What kind of hardware do I need?
  598.     o What are the costs?
  599.     o What do I get?
  600.     o Where do I go next to find out more, or explore current
  601.           possibilities?
  602.     o What are the prospects for the future?
  603.  
  604.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  605.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  606.  
  607.    Q14. What support is provided for Khoros by the Khoros group at UNM?  
  608.         What if I need additional support?
  609.  
  610.    A14. The best we can do here at UNM is to try to answer your mail to
  611.         khoros@chama.eece.unm.edu, and to post to our new news group,
  612.         comp.soft-sys.khoros -- a big job in itself for our small group.
  613.         We have decided that the best way to provide additional support
  614.         is via the Consortium.  Hopefully, in the future, one or more of
  615.         the Consortium members will take the initiative to provide Khoros
  616.         support.  
  617.          
  618.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  619.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  620.  
  621.  
  622. ========================== General Khoros ====================================
  623.  
  624.  
  625.    Q15. What is the Khoros Consortium?  What are the benefits of joining
  626.         the Consortium?  How much does it cost?
  627.  
  628.    Q15. The Khoros Consortium will oversee the distribution of the
  629.         Khoros software and the continued research and development
  630.         of the Khoros project.  There are two levels of membership
  631.     in the Consortium: a Supporting Member at $50,000/year, and an
  632.     Affiliate Member at $5000/year. Affiliate Members have the right
  633.     to redistribute the Khoros system and early access to enhancements
  634.         and updates;  Supporting Members have the right of redistribution and
  635.     early access to updates; they also participate on an advisory group 
  636.     as well as participate in staff exchange, and training sessions. 
  637.     For more information about joining the Consortium, send email 
  638.     to: consort@chama.eece.unm.edu
  639.      
  640.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  641.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  642.    
  643.    Q16. What machines does Khoros currently run on? 
  644.    A16. Please see the Khoros FAQ for Compiling, Q1.
  645.  
  646.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  647.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  648.  
  649.    Q17. Does Khoros work with shared libraries?  
  650.    A17. Please see the Khoros FAQ for Compiling, Q9.
  651.  
  652.  
  653.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  654.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  655.  
  656.    Q18. Can you use C++ with Khoros?  How?
  657.  
  658.    A18. Klamer Schutte, of the Faculty of Electrical Engineering at the 
  659.     University of Twente, The Netherlands, (klamer@mi.el.utwente.nl, 
  660.     SMTP: klamer@utelmi01.el.utwente.nl) provides the following answer:
  661.  
  662.     I am doing this now on a regular basis with Sun C++ 2.1. I use composer 
  663.     & ghostwriter to generate a main() with command line handling. The C++ 
  664.     function does the real thing.
  665.  
  666.     One problem: Sun C++ 2.1 needs a C++ main, not a C main. So I have a
  667.  
  668.     #define        main    my_main
  669.  
  670.     as a #define in the ghostwriter-generated C main. 
  671.     Also, I have a simple wrapper
  672.     in C++ for the main function:
  673.  
  674.     extern "C" my_main(int argc, char *argv[]);
  675.  
  676.     main(int argc, char *argv[])
  677.     {
  678.             return my_main(argc,argv);
  679.     }
  680.  
  681.     The library function also needs the extern "C" directive.
  682.  
  683.     Recently, I tried the same method with g++ 2.{1,2} and 
  684.     it worked similarly.
  685.  
  686.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  687.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  688.  
  689.    Q19. What file formats are supported by Khoros?  If Khoros doesn't support
  690.         my file format, is there any way to get my data into the Khoros system?
  691.  
  692.    A19. Khoros supports Sun Raster, Terra-Mar BIG, TGA, DEM, DLG, FITS, PBM,
  693.         and ELAS images;  there are routines to convert each of these file
  694.         formats to the VIFF format used by Khoros.  In addition, there are
  695.         also routines to convert ascii data and raw data to the VIFF format.
  696.         If your file format is not one of these, you can still import the 
  697.         image data to Khoros provided you can display the image.  Once any 
  698.         image is displayed on an X11 screen, the "getimage" program can be
  699.         used to store it as a VIFF image. 
  700.  
  701.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  702.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  703.  
  704.    Q20. I have some GIF images that I would like to use with Khoros.  Is
  705.         there a GIF to VIFF converter?
  706.  
  707.    A20. Currently, we do not have a gif2viff program, although we may put
  708.     one out in the future.   For the time being, you can convert your 
  709.     GIF image to PBM (Portable Bit Map) and then use the
  710.         khoros routine 'pbm2viff' to get it from PBM into VIFF format.
  711.         To convert your GIF image to PBM, the pbmplus package is very useful.
  712.         The pbmplus package is a public domain package that can obtained via
  713.         anonymous ftp on pprg.eece.unm.edu or export.lcs.mit.edu in the file
  714.         'pub/pbmplus.tar.Z'.
  715.  
  716.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  717.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  718.  
  719.    Q21.  I would like to remove all of Khoros that is not needed to 
  720.          actually run it, in order to free up disk space.   What can
  721.          be removed without compromising the integrity of the runtime 
  722.      operation of Khoros?
  723.  
  724.    A21.  The minimum set of directories that you need to run Khoros are:
  725.              bin     - of course for executables
  726.              repos   - user interface files
  727.         dotfiles- dotfiles for khoros environment
  728.  
  729.          You may also want to keep:
  730.             doc     - on line help
  731.             man     - man pages used by vman
  732.             manual  - printed manual
  733.  
  734.       You do not need the following for only a "runable" khoros:
  735.                src     - needed for compiling
  736.             lib     - needed for compiling
  737.             include - needed for compiling
  738.             data    - examples
  739.             release - documentation
  740.  
  741.  
  742.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  743.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  744.  
  745.    Q22. Is it possible to get only a subset of Khoros?  I realize that
  746.     Khoros has a core of utility routines that must be obtained, but
  747.     I was hoping that one could pick and choose the routines one wanted
  748.     on an as-needed basis.
  749.  
  750.    A22. No, sorry.  At this time, you must get the ENTIRE distribution to 
  751.         begin with.  After you have the system, you may selectively delete
  752.     programs that you are not interested in.  We do recommend that you
  753.     be very careful when deleting libraries, as deleting a library that 
  754.     existing routines link against may be fatal.  Making the distribution
  755.     of Khoros more modular has high priority for Khoros 2.0;  we understand
  756.     that it would be much more convenient to be able to acquire only those
  757.     programs in which one is interested. 
  758.  
  759.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  760.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  761.  
  762. ================ Manuals, Documentation, Man Pages =============================
  763.  
  764.  
  765.     Q23. Can I buy the manuals separately?
  766.     A23. Yes.  For a cost of $100 / set, you can order printed manuals from
  767.          us here at UNM.  See A7 for details.
  768.     
  769.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  770.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  771.  
  772.     Q24. How do I print the documentation?
  773.     Q24. Use the "prnmanual" program.  It is an interactive program
  774.       which will take you through a series of prompts in order to
  775.      print the desired portion of the manual.
  776.     
  777.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  778.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  779.  
  780.    Q25. I want to read the Khoros man pages, but vman doesn't seem to work.
  781.         What's the problem?
  782.  
  783.    A25. Be sure that you have run  the "customize" program before attempting 
  784.     to use "vman".  The "customize" program sets paths correctly so 
  785.     that "vman" knows where to go to find man pages.  
  786.  
  787.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  788.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  789.  
  790.    Q26. I can not regenerate the Khoros manual on a Sun Workstation
  791.         because soelim for .so lines in the roff files, limits the
  792.         file length to 64 characters.
  793.  
  794.    A26. This is a bug and has been reported to Sun, but not expected
  795.         to be fixed until the release after 4.1.2 (maybe). We are
  796.         distributing a public domain version of the soelim program.
  797.         If you think or know that your OS has this problem, then make
  798.         sure you have the "SoeLim" symbol set to YES in your sun.cf file.
  799.  
  800.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  801.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  802.  
  803. ==================  24 Bit Displays ===========================================
  804.  
  805.    Q27. Does Khoros work with 24-bit displays?  Can I expect any particular
  806.         problems when I run Khoros applications on my 24-bit display?
  807.  
  808.    A27. Yes, Khoros works with 24-bit displays.  However, there are some
  809.     complications with 24-bit displays;  please see the following questions
  810.      and answers for details.
  811.  
  812.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  813.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  814.  
  815.    Q28. Is there a way to load a 24-bit image, display it on an 8-bit display 
  816.     (using 3-3-2, or 7 levels each of rgb), and allow LUT manipulations, 
  817.     histograms, etc, to be done on the original values?  
  818.  
  819.    A28. Allowing such manipulations to be done on the original values of 24-bit 
  820.     images would have many advantages. We would like to do this in the 
  821.         future, as well as allow the manipulation of integer and short images.  
  822.     As time permits, we will be adding these kind of capabilities in the 
  823.     near and long term.  Our goal is to provide a merged display and 
  824.     graphics library that is flexible and is easy for the user to build 
  825.     new applications, and that handles this situation (among others) 
  826.     automatically.  
  827.  
  828.  
  829.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  830.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  831.  
  832.    Q29. When running warpimage on a 24-bit display, it fails and gives me
  833.         this X Protocol error:
  834.  
  835.         X Error of failed request:  BadMatch (invalid parameter attributes)
  836.         Major opcode of failed request:  72 (X_PutImage)
  837.         Minor opcode of failed request:  0
  838.         Resource id in failed request:  0x3800060
  839.         Serial number of failed request:  1783
  840.         Current serial number in output stream:  1810
  841.         Major X error encountered for display ':0.0'! Unable to recover.
  842.  
  843.    A29. Unfortunately, warpimage was never converted to work on a 24-bit
  844.         display.  You will have to use it exclusively on an 8-bit display.
  845.     If you do not need interactive warping (ie, you already know your
  846.     source and destination coordinates, or your warping coefficients),
  847.     you can use the non-interactive "vwarp" program.
  848.  
  849.  
  850.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  851.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  852.  
  853.    Q30. When running editimage and using the zoom, or ROI, or annotations 
  854.     options on a 24-bit display, it fails and gives me this X Protocol 
  855.     error:
  856.  
  857.         X Error of failed request: BadMatch (invalid parameter attributes)
  858.         Major opcode of failed request: 72 (X_PutImage)
  859.         Minor opcode of failed request: 0
  860.         Resource id in failed request:  0x4000041
  861.         Serial number of failed request: 6750
  862.         Current serial number in output stream: 6751
  863.         Major X error encountered for display ':0.0'! unable to recover.
  864.  
  865.    A30. The most likely problem is a conflict in the visuals that are being
  866.     used (for more info on how X describes color support with visuals, 
  867.     please see Volume 1 of O'Reilly: the XLib Programming Manual by Adrian 
  868.     Nye, section 7.2.4 and 7.2.5).  Editimage has an internal conflict
  869.     (a design flaw, if you will) in that it uses the default visual of 
  870.     the X Display (often 8-bit PseudoColor) for its zoom, ROI, and 
  871.     annotations operations;  however, the xvdisplay library (used by 
  872.     editimage to create the image) will attempt to create the image widget 
  873.     in such a way as to use the greatest depth visual that is available on 
  874.     your X Display.  On 24-bit displays, the greatest depth visual will 
  875.     usually be the 24-bit DirectColor visual.  Thus, when editimage 
  876.     attempts to use an operation using the PsuedoColor visual on an image 
  877.     created with a DirectColor visual, an X Protocol error results since 
  878.     the X resources being used are of differing visual types and depths, 
  879.     and X does not tolerate this.  
  880.  
  881.     A similar problem can result if the default is the TrueColor visual;
  882.     since this visual is Read-Only, editimage cannot work 
  883.  
  884.     To verify that this is really the problem, do % xdpyinfo on the 24-bit
  885.     display. On about the 39th line of output, it will tell you the default
  886.     visual id, and follow that with descriptions of each visual that is
  887.     available.  Find the description of the visual that matches the id 
  888.     given (it is usually the first one) and see if it says, 
  889.     "class: PsuedoColor" and "depth: 8 planes".
  890.  
  891.     After having verified that this is the problem, the situation can 
  892.     be remedied in one of two ways:
  893.  
  894.     1) Use an 8-bit display instead of a 24-bit display.
  895.  
  896.     2) Run your X Server using the 24-bit DirectColor visual as the 
  897.        default visual.  The procedure for this will vary according to 
  898.        computer and X Windows installation.  Some examples:
  899.        * if xdm is being used, you must change the "Xservers" 
  900.          configuration file to specify -class DirectColor -dd 24 
  901.        * if you are running xinit and not xdm, you can execute, 
  902.              % xinit -- -cc DirectColor. 
  903.        In the case of xdm, you might have to ask your system manager 
  904.        to change the configuration file for you, as it may require root 
  905.        permission.  For more information on your X server, execute, 
  906.        % man X  or % man Xserver.
  907.     
  908.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  909.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  910.  
  911.     Q31. I cannot seem to view my 24-bit image properly with editimage on
  912.      my SGI 24-bit display.  Editimage insists on compressing my image
  913.      to 8-bit PsuedoColor, but I don't want that.
  914.  
  915.     A31. The X Server provided by SGI does not support the 24-bit Read/Write
  916.      Direct Color visual.  The only 24-bit visual offered is the Read-Only 
  917.      TrueColor visual, which is not sufficient for editimage since 
  918.      editimage needs to modify the colormap for its LUT and PseudoColor
  919.      options.  Because of this, editimage compresses the 24-bit image to 
  920.      an 8-bit image in which it can use the PsuedoColor Read/Write visual 
  921.      to modify the colormap of the image.  
  922.  
  923.      You may view your 24-bit (rgb) image on an SGI by using the simpler
  924.      "putimage" program, which does not need to modify the image's colormap.
  925.  
  926.  
  927. ==================  Problems With Displaying Images   =========================
  928.  
  929.  
  930.    Q32. I'm on a SUN architecture, using OpenWindows 2.0. When I display images,
  931.         they come up  with colored speckles in them, or strangely colored in
  932.     some way. This condition rights itself when I move the cursor into 
  933.     the image, but then the colors in my user interface get messed up -
  934.     sometimes I can't see anything but the image.  Is this a bug in Khoros?
  935.  
  936.    A32. No, it is a result of us having to work around a bug in the X server 
  937.     which will cause the server to dump when any display routine attempts 
  938.     to create a private colormap.  We managed to work around the bug,
  939.     but at the cost of user interface colors no longer being defined as 
  940.     the original colors.  This implies that with any display routine, your 
  941.     user interface colors will be undefined if the programs cannot use 
  942.     the default colormap;  in this case, your user interface colors may 
  943.     disappear, may be arbitrarily defined, or may have their colors 
  944.     re-defined according to the current colormap.  The best you can do
  945.     is try to limit the colors used in your image, thus leaving more
  946.     color cells "left over" for the user interface to use.
  947.     Note that this bug has been fixed in OpenWindows 3.0.
  948.  
  949.  
  950.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  951.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  952.  
  953.    Q33. When I display an image that has a large number of colors in it
  954.     the colors will not be displayed correctly unless
  955.     I move my mouse into the image;  then, all my other windows lose
  956.     their colors.  How can I get rid of this "techno-flash" phenomenon?
  957.     NOTE: there is a difference between this problem and the one mentioned
  958.     in Q32.  In Q32, the graphical user interface is lost;  here, the
  959.     graphical user interface is preserved, but colors in other windows
  960.     are lost.
  961.  
  962.    A33. The number of colors that may be displayed nicely is X server 
  963.     dependent -- it also depends on the number of colors currently 
  964.     used by other windows on your display.
  965.  
  966.     For color rgb (3-band) images, use the vgamut program to reduce the 
  967.     number of  colors, using the [-n] option to specify the number of 
  968.     colors you want in the compressed image. 
  969.  
  970.     For psuedocolor images, you first must use the vmapdata program to 
  971.     convert the image into a temporary 3-band rgb image; use this
  972.     temporary image as input to vgamut, as described above. 
  973.  
  974.     For grey scale images with no map, you may want to use 
  975.     v1bgamut (one-band gamut) to reduce the number of colors.
  976.     Another method is to use vconvert to convert the image to type 
  977.     BYTE, scale by 0.5, and multiply by 2.0, thus quantizing the grey 
  978.     levels to 7 bits (even values 0-254).
  979.  
  980.     There are a very large number of ways that images can
  981.     be modified to use a reduced number of pixels;  explanations of
  982.     other methods are omitted here.  To begin with, the user should see
  983.     man pages on vgamut, v1bgamut, vmapdata, vconvert, and vmsquish. 
  984.     
  985.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  986.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  987.  
  988. ================  Problems With SGI  ==========================================
  989.  
  990.    Q34. The Khoros display programs are not working on SGI machines.  The 
  991.         symptom is that when displaying images a title bar will appear, but 
  992.         no window -- just an hole where the image should be.  
  993.  
  994.    A34. We have found what appears to be a bug with SGI's Xsgi server.  
  995.         The bug is with the shape window extension and seems to only appear 
  996.         on machines that are running either the 3.3.1 or 3.3.2 maintenance 
  997.         update.  It does work however with the original 3.3 distribution.  
  998.         To identify what version of the Xsgi server is installed on your 
  999.         machine, run the following command:
  1000.  
  1001.         % /usr/sbin/versions long | grep Xsgi
  1002.  
  1003.         If "versions" returns the string below then all should be well:
  1004.  
  1005.         f 39751  1569 eoe2.sw.X11             usr/bin/X11/Xsgi
  1006.  
  1007.         If "versions" returns either of these two strings then the display 
  1008.         routines will not work:
  1009.  
  1010.         f 34353  1569 maint1.eoe2_sw.X11      usr/bin/X11/Xsgi
  1011.         f 34353  1569 maint2.eoe2_sw.X11      usr/bin/X11/Xsgi
  1012.  
  1013.     In the 4.0 version of the operating system, this the bug is fixed.  
  1014.     Patch 1 of Khoros fixed the problem by totally disabling the shape 
  1015.     option for SGI servers.
  1016.  
  1017.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1018.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1019.  
  1020.    Q35. On our SGI (NCD terminal with an SGI server), when the Khoros 
  1021.     applications come up, they have extremely large graphical user 
  1022.     interfaces.  The user interface is so large, it doesn't even fit 
  1023.     on the screen!  What can I do?
  1024.  
  1025.    A35. A bug in the SGI 3.3.x X Server prevents default fonts being 
  1026.     read from the .Xdefaults file by the xvforms library, causing 
  1027.     Khoros applications to come up with unpredictable fonts.   To find 
  1028.     out which fonts are available on your display, use:
  1029.  
  1030.         % xlsfonts 
  1031.  
  1032.     Then, use your favorite font with the [-fn] option that is provided 
  1033.      with all Khoros applications that have a graphical user interface.  
  1034.     We recommend the "fixed" font, if it is available.  For example,
  1035.  
  1036.         % editimage -fn fixed
  1037.  
  1038.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1039.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1040.  
  1041. ================= Annotations, Editimage, Xprism2/3, Animate ==================
  1042.  
  1043.  
  1044.    Q36.  I have a problem with the annotations capability in editimage (xprism).
  1045.      When I move the image (plot), the annotations don't move accordingly.
  1046.      It seems that they are tied to the device coordinates of the screen,
  1047.      rather than the pixels in the image (world coordinates of the plot)
  1048.      as they should be.
  1049.  
  1050.    A36.  This is true.  You are noticing a design limitation in the annotations
  1051.      implementation.  Annotations were originally created to work on device
  1052.      coordinates, with future plans to upgrade them to work on the pixels
  1053.      in the image / world coordinates of the plot.  Unfortunately, we still 
  1054.      have not added this capability.   We hope to rectify this for 
  1055.      Khoros 2.0.
  1056.  
  1057.  
  1058.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1059.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1060.  
  1061.    Q37. I am trying to load 3D data into xprism3 from an ASCII file.
  1062.         When I try to plot the data, a pop-up window states that there 
  1063.     is 1 row and (total # data points) columns, and asks for the correct
  1064.         number of rows. What is going on?
  1065.  
  1066.    Q37. When you input data points into xprism3, there is nothing in the data 
  1067.     to indicate how many rows and columns are included in the data.
  1068.  
  1069.         While row & column information is not needed to do a scatter
  1070.         plot, for instance,  it is required in order to draw a mesh plot, a
  1071.         surface plot, and others.
  1072.  
  1073.     Suppose you have 200 data points.  Xprism3 does not know
  1074.         whether you want 1 long row of 200 points, or 2 rows of 100 points
  1075.     each, or 5 rows of 40 points, etc:  so, you have to *tell* it what
  1076.         you mean.  If you are providing the data file as input from the
  1077.         command line, you would specify the number of rows with the [-rows]
  1078.         option, as in the following data file containing 5 rows of 38
  1079.         points (columns) each:
  1080.  
  1081.         % xprism3 -i11 data2.pts -rows11 5
  1082.  
  1083.         If you input the data file from the "Input File" pane of the "Plot"
  1084.         subform, you will be prompted by a pop-up window noting that the 
  1085.      default is to have 1 row of 200 columns (one long row with 200 points 
  1086.         in it).  If you really wanted 5 rows of 40 points (columns) each, you 
  1087.      would correct xprism3 by substituting a 5 for the 1 in the pop-up 
  1088.     window.  From that point on, the default action would be for xprism3 
  1089.     to assume that all subsequent sets of data points all have 5 rows;  
  1090.     the number of points in each row (the number of columns) is computed 
  1091.     as the total number of points divided by the number of rows specified.  
  1092.     If you then enter a set of data points that has, say, 2 rows, you will 
  1093.     have to correct xprism3 again by entering "2" in the pop-up window.
  1094.  
  1095.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1096.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1097.  
  1098.    Q38. What does the "*" mean after a pixel value at the bottom of
  1099.         the editimage window?
  1100.  
  1101.    A38. This is an indication of whether the pixel was _actually_ allocated. 
  1102.     If a "*" is displayed, this means that the pixel being displayed has 
  1103.     really been mapped to its closest available neighbor.  On an 8-plane
  1104.     display, an application can only have up to 256 colors; this means that 
  1105.     the application and the image must share these colors.  So, if you
  1106.     display a byte image with 254 colors, you will only have 2 colors left
  1107.         for the user interface colors and special application displays.  For
  1108.         editimage, special colors like red, green, blue, white, black, yellow,
  1109.         cyan, magenta, and gray are used with the application display
  1110.         components such as LUT and PSEUDO.  But, you have only 2 colors left --
  1111.     what should be done?   What editimage does to deal with this problem
  1112.     is to allocate all the special colors and user interface colors first,
  1113.     to ensure that the user interface will not be corrupted; image colors 
  1114.     are allocated next.  When the image needs more colors than are 
  1115.     available, the xvdisplay library will find the closest available colors 
  1116.     from the previously allocated pixels;  thus, a particular pixel being
  1117.     displayed on the screen may actually represent 2 or more actual pixel
  1118.     values from the image data.  Thus, when you move the mouse around the 
  1119.     image, these special pixels have a "*" displayed to indicate this 
  1120.     situation where it occurs.
  1121.  
  1122.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1123.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1124.  
  1125.    Q39. I am running animate on a DecStation 5000/200 PX or PXG.  Animate is 
  1126.     so slow that it is unusable.  Occasionally, it even seems to lock up 
  1127.     the display.  What is the problem?
  1128.  
  1129.    A39. There is only limited pixmap hardware memory available on the PX and
  1130.     PXG.  The default action of animate is to use a pixmap Use animate 
  1131.         with the [-pixmap false] option.
  1132.  
  1133.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1134.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1135.  
  1136.    Q40. When plotting raw ASCII data specified in XYZ format, does the data 
  1137.         have to be rectangular?  Does each row have to have the same 
  1138.     number of elements?  Is there anyway to plot 3D data that has a 
  1139.     varied number of points per row?
  1140.  
  1141.    A40. Currently, xprism3 does allow you to have unevenly spaced 
  1142.         points, but the number of points in each row must be the same in order
  1143.     to do a mesh, colormesh, surface, horizon, contour 2D or 3D plot.  You
  1144.     can do a 3D scatter plot with a varying number of points in each row:
  1145.     simply tell xprism3 that you have 1 long row of (total number) points. 
  1146.     To get an accurate plot in this situation, however, you are limited
  1147.     to scatter plots.
  1148.     
  1149.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1150.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1151.  
  1152. ==================  Problems with Graphical User Interface ==================
  1153.  
  1154.    Q41. I have a version of Khoros installed on a DecStation running the 
  1155.         dxwm window manager (DecWindows).  I have problems with running
  1156.         Khoros interactive programs such as cantata, xprism2/3, etc -- 
  1157.     some of the buttons do not work at all, while others sometimes lock 
  1158.     the program, or otherwise do not act properly.  What's wrong?
  1159.  
  1160.    A41. Khoros does not behave well at all under dxwm (DecWindows).
  1161.     What usually happens is that the application in question needs 
  1162.     to pop up a warning message, error message, or other pop-up window;  
  1163.     but dxwm does not map the pop-up message for some reason.  
  1164.     So the application sits there and waits for you to acknowledge an 
  1165.     error message that never came up -- thus giving the impression that 
  1166.     nothing is happening.  Since we can't provide you with advice on how 
  1167.     to fix the problem, we recommend obtaining a copy of either twm 
  1168.     (Tab Window Manager) or mwm (Motif Window Manager) and using that 
  1169.     instead of dxwm.  DEC is phasing out dxwm and migrating to mwm.
  1170.  
  1171.  
  1172.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1173.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1174.  
  1175.    Q42. I'm using khoros on a monochrome monitor. I have connected up some
  1176.         glyphs in the cantata workspace, but the connections don't appear
  1177.         on the screen, even though the workspace executes correctly.
  1178.  
  1179.    A42. You need to set up your X resources so that the connections and
  1180.         workspace background appear different.  Cantata defaults to using X
  1181.         resources that are appropriate for color screens, and which may be
  1182.         inappropriate for monochrome monitors.  The file
  1183.  
  1184.               $KHOROS_HOME/dotfiles/Xdefaults.monochrome
  1185.  
  1186.         contains the appropriate resources.  Include this file (or as many
  1187.         lines of the cantata.???? as you want) in your .Xdefaults file, and
  1188.         reload the X resource database (xrdb -merge ~/.Xdefaults).  This
  1189.         should solve the problem.
  1190.  
  1191.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1192.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1193.  
  1194. ==================  Writing New Programs Under Khoros ========================
  1195.  
  1196.  
  1197.    Q43. I have finished writing my new program under Khoros, and now
  1198.     I would like to install it into a toolbox, and integrate it 
  1199.     into the cantata visual language.  How do I go about doing this?
  1200.  
  1201.    A43. First of all, you must create and install your toolbox.
  1202.     At the end of Chapter 1 ("Writing Programs") of Volume II of
  1203.         the Khoros Manuals ("The Khoros Programmer's Manual") is a 
  1204.         section on "The Use of Toolboxes"; this is required reading
  1205.     for those who wish to learn to use toolboxes. Also, there
  1206.     is an application called "kraftsman" that will help you
  1207.     create and manage your toolbox. Consult Volume II, Chapter 11
  1208.     of the Khoros Manual for more information.
  1209.     
  1210.     Next, you will want to modify the cantata UIS form in your toolbox 
  1211.     to include your new program(s). This also covered in Chapter 1 
  1212.     ("Writing Programs") of the  Khoros Programmer's Manual, in the
  1213.     section entitled, "INTEGRATING THE NEW PROGRAM INTO CANTATA".
  1214.     
  1215.     Finally, you will want to make use of your new, modified cantata UIS 
  1216.     form instead of the original. using:
  1217.  
  1218.     % cantata -restore {toolbox name}/repos/cantata/cantata.form
  1219.  
  1220.     or by specifying this alternative cantata.form file in your
  1221.     .Xdefaults file, as in:
  1222.  
  1223.     cantata.Form: {toolbox name}/repos/cantata/cantata.form
  1224.  
  1225.  
  1226.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1227.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1228.  
  1229.    Q44. Is there a tutorial describing how to create and install an xvroutine?
  1230.  
  1231.    A44. Yes, the tutorial was created and provided by Carla Williams
  1232.         (carla@chama.eece.unm.edu).  Here is what she has to say:
  1233.  
  1234.     "For your edification and entertainment I have created a 'cook-book'
  1235.      style tutorial that will take you through the steps required to
  1236.      create a new vroutine (based on an existing one), test it in cantata,
  1237.      install in a toolbox, and access via the main cantata menu.  
  1238.      It is a supplement to Volume II the Khoros Programmer's Manual.
  1239.  
  1240.      The tutorial is available for ftp in the contrib directory on pprg:
  1241.          ftp to  pprg.eece.unm.edu
  1242.          cd to  /pub/khoros/contrib
  1243.  
  1244.          You will find the two files:
  1245.  
  1246.          README.vroutine_tutorial
  1247.          vroutine_tutorial
  1248.  
  1249.          If you decide to try it out, please give me feed-back (both positive
  1250.          and negative!) as I plan to use it as part of a training course on 
  1251.          using Khoros.
  1252.  
  1253.          Enjoy!
  1254.  
  1255.          Carla Williams
  1256.          carla@chama.eece.unm.edu
  1257.  
  1258.  
  1259.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1260.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1261.  
  1262.    Q45.  Can user-written routines be installed under existing buttons on
  1263.          the Cantata workspace? For example, if I have written a new
  1264.          signal processing routine, can I fix things so that it appears
  1265.          on the menu under the Signal Processing button, or do I have to
  1266.          install it in a new toolbox?
  1267.  
  1268.    A45.  Brad Castalia, of the University of Arizona 
  1269.      (castalia@gaea.lpl.arizona.ed) provides the following answer:
  1270.  
  1271.          While individual routines can be added to the Khoros base structure
  1272.          (e.g. new library functions and/or libraries, new executables,
  1273.          and new forms), this is probably not advisable except in
  1274.          extraordinary situations as the resulting upgrades will be a
  1275.          management nightmare. Thus using the toolbox mechanism should
  1276.          be used whenever possible. the following procedure offers a
  1277.          general outline of how to add general access toolboxes into the
  1278.          cantata environment:
  1279.      
  1280.          After building and testing the new software to the point of
  1281.          satisfaction (or obtaining a user-contributed toolbox), the new
  1282.          software is installed as a general access toolbox in a
  1283.          subdirectory of the $KHOROS_HOME/toolboxes directory (this
  1284.          location is not necessary, it's just convenient for management
  1285.          purposes). Be sure that you do NOT name the subdirectory the
  1286.          same name (regardless of case) as the name of the toolbox (due
  1287.          to an unfortunate bug in the software management tools)! If the
  1288.          toolbox is user-contributed, you will at least need to be sure
  1289.          the KHOROS_USER and LOCAL_SRC_TOP variables are correctly set
  1290.          in the repos/config/src_conf/<toolbox>_mf file. Checking
  1291.          pathname references in UIS files is a good idea too.
  1292.      
  1293.          Update the $KHOROS_HOME/repos/cantata/cantata.form file (you
  1294.          should probably work on a copy). About a third of the way into
  1295.          the file you will encounter the groups of -D/-u lines that
  1296.          define the main toolbox collection buttons that appear across
  1297.          the top of the cantata workspace. Pick the collection where
  1298.          you would like the toolbox to appear (e.g. SIGNAL PROCESSING)
  1299.          and add a duplicate of one of the -u lines at the point in the
  1300.          list where your new toolbox should be listed (e.g. duplicate
  1301.          the line containing 'Spectral Estim.' if you want to add your
  1302.          toolbox to the end of the list). Change the descriptive name
  1303.          (inside single quotes) to an appropriate descriptive name for
  1304.          your toolbox (this need not be identical to the toolbox name
  1305.          itself). NOTE THE POSITION OF THIS NEW -u LINE IN THE LIST.
  1306.          Proceed down to the last third of the cantata.form file to
  1307.          where the long list of -k lines is located. Duplicate the -k
  1308.          line corresponding to the -u line you duplicated above (you
  1309.          MUST get the order right %-(, count the lines to be sure). To
  1310.          make this easier, add comment lines (beginning with a #
  1311.          character), containing the same toolbox collection names on the
  1312.          -D lines from above, to delineate the -k lines into
  1313.           recognizable groups. Change the -k line to reference your
  1314.          toolbox .sub UIS file. For example, to add a toolbox called
  1315.          FILMWRITER to the end of the OUTPUT collection list, after the
  1316.          line
  1317.      
  1318.              -k KHOROS_HOME/repos/cantata/subforms/output_dither/dither.sub
  1319.      
  1320.          add
  1321.      
  1322.              -k $FILMWRITER/repos/cantata/subforms/filmwriter.sub
  1323.      
  1324.          Notice the reference to the toolbox name variable in the
  1325.          pathname.
  1326.      
  1327.          Update the $KHOROS_HOME/repos/Toolboxes file. This may already
  1328.          have been done for you if you used kinstall. It should have a
  1329.          line beginning with your toolbox name (e.g. FILMWRITER in the
  1330.          example above), with other descriptive fields following (follow
  1331.          the model of the other lines in the file). Be sure the second
  1332.          field (after the colon following the toolbox name) contains the
  1333.          path to the directory where the new toolbox is located.
  1334.      
  1335.          Add links in $KHOROS_HOME/bin that point to the executable
  1336.          files in the new toolbox (usually in the bin subdirectory of
  1337.          the toolbox directory structure).
  1338.      
  1339.          Run cantata to check out the new installation.
  1340.      
  1341.  
  1342.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1343.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1344.  
  1345. ======================   Miscellaneous  =======================================
  1346.      
  1347.      
  1348.    Q46. Where did you get the name "Khoros"? Is it an acronym?
  1349.  
  1350.    A46. Khoros is not an acronym; rather, it is the greek word for
  1351.         "chorus". A definition of a "chorus" is: a company of
  1352.         singers or dancers who sing or dance in concert.
  1353.         We chose the name "Khoros" because we felt that it was symbolic
  1354.         of our objectives for our software system.  The "singers or dancers"
  1355.         are the many programs in the Khoros system;  our objective is to
  1356.         provide a group of programs that will, when used in concert,
  1357.         provide a harmonious environment for the the user.
  1358.  
  1359.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1360.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1361.  
  1362.    Q47. I would like to do 3D object modelling, with multiple light sources,
  1363.     animation, and so on.  Does Khoros do this?
  1364.  
  1365.    A47. No, sorry.  At this time, Khoros is geared more towards imaging than
  1366.     volume modelling or rendering.  We suggest you try AVS or Explorer for
  1367.     this types of work.  Both packages provide excellent object modelling 
  1368.     and rendering.  
  1369.  
  1370.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1371.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1372.  
  1373.    Q48. I heard about the audio cantata demo, and would like to hear it.
  1374.         How do I go about this?
  1375.  
  1376.    A48. First of all, you have to be on a SparcStation (SUN4), and
  1377.         you must have the raw2audio program installed.  raw2audio is a
  1378.         program distributed by SUN; it is not part of Khoros.
  1379.  
  1380.         Go to /usr/demo/SOUND, and compile the code that is there using
  1381.         the Makefile provided.   Note that in this directory is the file
  1382.         raw2audio.c -- when you compile this directory, you will get the
  1383.         raw2audio* executable.  Then you may use the dsp.Z workspace with
  1384.         cantata to hear the demo.
  1385.  
  1386.         Note that if /usr/demo/SOUND does not exist on your SUN system, you
  1387.         must install it -- it should be available on the SUN OS 4.1.1
  1388.         distribution tape.
  1389.  
  1390.     The cantata workspace to run the sound demo file is available
  1391.         anonymous ftp from pprg.eece.unm.edu (129.24.24.10) in the 
  1392.         directory /pub/khoros/misc/workspaces;  it is called dsp.Z.  Be sure you
  1393.         have bin set (ftp> bin) before acquiring the compressed workspace.
  1394.  
  1395.  
  1396.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1397.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1398.  
  1399.    Q49. Is there a way to convert VIFF images with 3 color bands (rgb) to
  1400.     images with only one band and a colormap?  What about vice versa?
  1401.  
  1402.    A49. To convert VIFF images with 3 color bands (rgb) to images with only 
  1403.     one band and a colormap, use the vgamut program, using the [-n] option 
  1404.     to specify the number of colors you want in the compressed image.  
  1405.     Many of the Khoros routines will require that you use vgamut on your 
  1406.     3-band image before using them.
  1407.  
  1408.     To convert a single-band VIFF image with a colormap (a pseudocolor 
  1409.     image) to an RGB image, you can use vmapdata to map the image data 
  1410.     through the maps, which will result in an RGB image. However, the 
  1411.     colors will still be quantified to 256 values as they were in the 
  1412.     psuedocolor image (your " VIFF-with-colormap") -- therefore, the 
  1413.     resulting will not look the same as the original image did (assuming 
  1414.     the "original" image was an RGB image, and that is where the 
  1415.     psuedocolor image originated from).  You cannot go back to the full, 
  1416.     original RGB information given only a psuedocolor image. After using 
  1417.     vmapdata (which creates a single image), if you want 3 separate images, 
  1418.     you can then use vbandspt3 to extract the 3 bands from the image and 
  1419.     create 3 new images, each containing one of the R, G, and B bands.
  1420.  
  1421.  
  1422.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1423.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1424.  
  1425.    Q50. We are trying to run cantata on an NCD Xterminal as the display, 
  1426.         and the program fails, exiting with the following error:
  1427.  
  1428.         X Error:  BadAlloc
  1429.           Request Major code 65 ()
  1430.           Request Minor code 0
  1431.           ResourceID 0x2400085
  1432.           Error Serial #1576
  1433.           Current Serial #1582
  1434.        Major X error encountered for display ':0'! Unable to recover.
  1435.  
  1436.    A50. You are probably running out of memory.  One solution is, of course,
  1437.         to inquire and install more memory.  However, you are especially likely
  1438.         to run out of memory if you have Backing Store and/or Save Unders on.  
  1439.         If you look at the system setup you can see how much remaining memory 
  1440.         remains before starting cantata or displaying images.  You should be 
  1441.         able to set whether you want backing store "on demand", "always", or 
  1442.         "off".  You may want to try setting it to "on demand" or "off".
  1443.  
  1444.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1445.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1446.  
  1447.    Q51. When I try to use my double or double complex viff image that came from
  1448.         another kind of machine, the program always gives an error.  What gives?
  1449.  
  1450.    A51. The support for double and double complex machine format translation 
  1451.         is not complete.  Unlike all other data types, which will be 
  1452.         transparently converted to the current architecture when loaded, 
  1453.         reading double precision data that was generated by another 
  1454.         architecture will cause an error in the translation code.  Presently, 
  1455.         no translation code for double precision exists.
  1456.  
  1457.  
  1458.